package com.business.api.official.toursism.websitegoods.service;

import com.business.api.official.toursism.websitegoods.dto.WebsiteGoodsApiDTO;
import com.business.api.official.toursism.websitegoods.from.WebsiteGoodsApiSaveFrom;
import com.business.api.official.toursism.websitegoods.from.WebsiteGoodsApiUpdateFrom;
import com.business.api.official.toursism.websitegoods.query.WebsiteGoodsApiPageQuery;
import com.business.api.official.toursism.websitegoods.query.WebsiteGoodsApiQuery;
import com.business.api.official.toursism.websitegoods.vo.*;
import com.business.api.official.toursism.websitegoods.vo.data.WebsiteGoodsApiDetailData;
import com.business.system.official.toursism.websitegoods.entity.WebsiteGoods;
import com.seed.core.exception.ServiceException;
import com.seed.core.pojo.service.SeedApiService;

/**
 * @description 商品
 * @author CodeGenerator
 * @date   2025-01-25
 * @version V1.0
 */
public interface WebsiteGoodsApiService extends SeedApiService<WebsiteGoods>{

    /**
     * 持久化
     *
     * @param websiteGoodsFrom 需要保存的对象
     * @return id，如果保存失败返回空字符串
     * @throws ServiceException 业务层异常
     */
    WebsiteGoodsApiDTO save(WebsiteGoodsApiSaveFrom websiteGoodsFrom) throws ServiceException;

    /**
     * 部分更新
     *
     * @param websiteGoodsFrom 需要更新的对象
     * @return 是否成功
     * @throws ServiceException 业务层异常
     */
    WebsiteGoodsApiDTO updateSelectiveById(WebsiteGoodsApiUpdateFrom websiteGoodsFrom) throws ServiceException;

    /**
     * 获取全部
     *
     * @param query 查询条件
     * @return 详情VOList
     * @throws ServiceException 业务层异常
     */
    WebsiteGoodsApiDetailListVO listAll(WebsiteGoodsApiQuery query) throws ServiceException;

    /**
     * 简略对象条件查询
     *
     * @param query 查询条件
     * @return 查询出来的简略对象
     * @throws ServiceException 业务层异常
     */
    WebsiteGoodsApiBriefPageVO getBriefPageVO(WebsiteGoodsApiPageQuery query) throws ServiceException;

    /**
     * 详细对象条件查询
     *
     * @param query 查询条件
     * @return 查询出来的详细对象
     * @throws ServiceException 业务层异常
     */
    WebsiteGoodsApiDetailPageVO getDetailPageVO(WebsiteGoodsApiPageQuery query) throws ServiceException;
}
